package cn.tedu.property.management.service;

import cn.tedu.property.management.pojo.dto.VisitPeopleAddNewDTO;
import cn.tedu.property.management.pojo.dto.VisitPeopleUpdateDTO;
import cn.tedu.property.management.pojo.entity.VisitPeople;
import cn.tedu.property.management.pojo.vo.VisitPeopleListItemVO;
import cn.tedu.property.management.pojo.vo.VisitPeopleStandardVO;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

/**
 * 处理访客数据的业务接口
 *
 * @author java@tedu.cn
 * @version 0.0.1
 */
@Transactional
public interface IVisitPeopleService {
    /**
     * 添加访客
     *
     * @param visitPeopleAddNewDTO 新的访客数据
     */
    void addNew(VisitPeopleAddNewDTO visitPeopleAddNewDTO);

    /**
     * 删除访客
     * @param id 访客id
     */
    void delete(Long id);

    /**
     * 修改访客详情
     * @param id 被修改的访客id
     * @param visitPeopleUpdateDTO 封装了访客id和新数据的对象
     */
    void updateInfoById(Long id, VisitPeopleUpdateDTO visitPeopleUpdateDTO);

    /**
     * 根据访客id查询访客详情
     *
     * @param id 访客id
     * @return 匹配的访客详情，如果没有匹配的数据，将抛出异常
     */
    VisitPeopleStandardVO getStandardById(Long id);

    /**
     * 查询访客列表
     * @return 访客数据列表
     */
    List<VisitPeopleListItemVO> list();
}
